home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls036.1.Z / tls036.1 / usr / man / cat.SMT / mkcuts.SMT.z / mkcuts.SMT
Encoding:
Text File  |  1992-09-15  |  6.8 KB  |  181 lines
  1.  
  2.  
  3.  mkcuts(SMT)                          .                           mkcuts(SMT)
  4.  
  5.  
  6.  
  7.  _N_a_m_e
  8.  
  9.     mkcuts - make custom-installable distribution (application cutting tool)
  10.  
  11.  _S_y_n_t_a_x
  12.  
  13.     mmkkccuuttss [--cc] [--ii] [--ss] [--uu] [--ff _vvvv_aaaa_rrrr_ssss______ffff_iiii_llll_eeee]
  14.  
  15.  _O_p_t_i_o_n_s
  16.  
  17.  
  18.     --cc  compresses the files in the product
  19.  
  20.     --ii  produces disk image files rather than cutting directly to the media
  21.  
  22.     --ss  produces a sumlist file listing the checksum of each file in the dis-
  23.         tribution
  24.  
  25.     --ff  sources the named file to set the required environment variables.  If
  26.         the --ff option is not given, mmkkccuuttss sources the file ./_s_i_t_e__v_a_r_i_a_b_l_e_s
  27.         by default.
  28.  
  29.     --uu  display command line usage, then quit
  30.  
  31.  
  32.  _D_e_s_c_r_i_p_t_i_o_n
  33.  
  34.     mmkkccuuttss is a tool for making ccuussttoomm-installable application distributions.
  35.     mmkkccuuttss uses ffiixxppeerrmm to extract the information in the permlist
  36.     ./_d_i_s_t/_t_m_p/_p_e_r_m_s/_pppp_rrrr_dddd to determine which files are on the distribution.
  37.     Once it has this information, it runs a series of programs that create
  38.     the distributions.
  39.  
  40.     ffddffiitt fits the files on the volumes in the most efficient order taking
  41.     care to put specified files on specified volumes where indicated.  For
  42.     example, init scripts, in general, are on the last volume; installation
  43.     tools are generally on the first volume.  It creates files in $$MMIISSCCDDIIRR,
  44.     which are named _0_1 ...  _0_nnnn and contain the list of files on that volume.
  45.     vvoollnnoo looks in these files, $$MMIISSCCDDIIRR//##, and updates each file's entry in
  46.     the permlist, ./_d_i_s_t/_t_m_p/_p_e_r_m_s/_pppp_rrrr_dddd, with the corresponding volume number.
  47.     ppkkggssiizzee calculates the total size used by each package listed in the
  48.     permlist and updates the permlist with this value.  ffiixxppeerrmm is run on the
  49.     distribution hierarchy to set permissions and ownerships to match those
  50.     of the permlist.  You must be running as _r_o_o_t so that ffiixxppeerrmm runs
  51.     correctly.
  52.  
  53.     mmkkccuuttss uses a number of shell variables to obtain information about the
  54.     product and the cutting environment. mmkkccuuttss sets these variables by
  55.     sourcing the file given with the --ff option, or the ./_s_i_t_e__v_a_r_i_a_b_l_e_s file
  56.     if no --ff option is used.
  57.  
  58.     The variables that need to be changed for each product cut with mmkkccuuttss
  59.     are:
  60.  
  61.     PPRROODDSSEETT        full name of the product, for example, ``SCO Profes-
  62.                    sional''
  63.  
  64.     PPRROODDPPRRDD        short or abbreviated product name, for example, ``pro''
  65.  
  66.     PPRROODDTTYYPP        code for the target machine and environment, for example
  67.                    ``n386''
  68.  
  69.     PPRROODDRREELL        current release number/name, for example, ``3.2.0a''
  70.  
  71.     PPRROODDUUPPDD        update string; optional field only needed for an update,
  72.                    for example, ``UA''
  73.  
  74.     TTAARRGGEETT__OOSS      operating system for which the product is intended;
  75.                    ``UNIX'' or ``XENIX'
  76.  
  77.     The variables that need to be changed for each different media type used
  78.     in a cut are:
  79.  
  80.     DDEEVVIICCEE         device name for archiving distribution, for example,
  81.                    /_d_e_v/_r_f_d_0_9_6_d_s_1_5
  82.  
  83.     VVOOLLSSIIZZEE        size of each distribution volume, for example, ``1185k''
  84.  
  85.     BBLLOOCCKKIINNGG       blocking factor (if required), for example, ``10''
  86.  
  87.     FFOORRMMAATT         complete command needed to format a volume, for example,
  88.                    ffoorrmmaatt --ff /_d_e_v/_r_f_d_0_9_6_d_s_1_5
  89.  
  90.     NNOOTTAARR          pathnames of any files not to be put onto the distribution
  91.                    media.  This is used to stop link names from being put
  92.                    onto the media by ttaarr.  (Links are made by ffiixxppeerrmm when
  93.                    the product is installed.)
  94.  
  95.     Some special-purpose variables that are used for some products, but do
  96.     not usually need to be changed from their default values, are:
  97.  
  98.     SSEERRIIAALLKKEEYY      serialization key for serialization; optional, only if
  99.                    debranding files
  100.  
  101.     SSEERRIIAALLIIZZEE      pathnames of any serialization files; optional, only if
  102.                    debranding files
  103.  
  104.     VVOOLLPPRREEFFIIXX      optional prefix letters for the volume number field in the
  105.                    permlist.
  106.  
  107.     NNOOCCOOMMPPRREESSSS     lists packages that are not to be compressed when the --cc
  108.                    option is used.  For example:
  109.  
  110.                       NNOOCCOOMMPPRREESSSS==""PPEERRMM IINNSSTT TTOOOOLLSS""
  111.  
  112.                    This ensures that the PPEERRMM, IINNSSTT, and TTOOOOLLSS packages in
  113.                    the product are not compressed when the other files in the
  114.                    product are compressed by mmkkccuuttss.  If NNOOCCOOMMPPRREESSSS is blank
  115.                    or not set, the --cc option compresses all files in the dis-
  116.                    tribution except the permlist.
  117.  
  118.     The following variables define certain parts of the cutting hierarchy,
  119.     and are almost never changed from their default values.
  120.  
  121.     DDIISSTTDDIIRR        ``root'' directory of the distribution hierarchy, for
  122.                    example, _pppp_wwww_dddd/_d_i_s_t
  123.  
  124.     CCDDIISSTTDDIIRR       ``root'' directory of the compressed distribution hierar-
  125.                    chy, where the files in the distribution are compressed
  126.                    when the --cc option is used
  127.  
  128.     MMIISSCCDDIIRR        distribution ``misc'' directory, relative to DDIISSTTDDIIRR used,
  129.                    for example, to store list of files corresponding to vol-
  130.                    umes
  131.  
  132.     SSUUMMDDIIRR         If a sum list of the final product is desired, mmkkccuuttss
  133.                    places it in the sum-directory listed, under the subdirec-
  134.                    tory SSUUMMDDIIRR/PPRROODDRREELL/MMEEDDIIAA.
  135.  
  136.     IIMMAAGGEEDDIIRR       directory under which the distribution image files are
  137.                    placed when the --ii option is used.  The files are placed
  138.                    under the subdirectory IIMMAAGGEEDDIIRR/PPRROODDRREELL/MMEEDDIIAA.
  139.  
  140.  
  141.  _S_e_e _a_l_s_o
  142.  
  143.     ffddffiitt(SMT), ffiixxppeerrmm(M), vvoollnnoo(SMT)
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.